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SYSTEM FOR SOFTWARE APPLICATION 
DEVELOPMENT AND MODELING 



Inventors: Todd Little 
5 Loren Konkus 

COPYRIGHT NOTICE 
[0001] A portion of the disclosure of this patent document contains 
material which is subject to copyright protection. The copyright owner has no 
1 0 objection to the facsimile reproduction by anyone of the patent document or the 
patent disclosure, as it appears in the Patent and Trademark Office patent file 
or records, but otherwise reserves all copyright rights whatsoever. 



Claim of Priority: 

15 [0002] This application claims priority from provisional application 
"SYSTEM FOR SOFTWARE APPLICATION DEVELOPMENT AND 
MODELING," Application No. 60/238,561 , filed October4, 2000, and "SYSTEM 
AND METHOD FOR COMPUTER CODE GENERATION", Application No. 
60/238,559, filed October 4, 2000, and is related to "SYSTEM AND METHOD 

20 FOR COMPUTER CODE GENERATION", Application No. , Inventors 

Todd Little, Loren Konkus, Gilles Lavalou and Timo Metsaportti, filed October4, 
2001, all of which are incorporated herein by reference. 



Field of the invention: 
25 [0003] Theinvention relatesgenerallytocomputersoftwaredevelopment 
systems and specifically to a system for developing and modeling software 
applications. 
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Background: 

[0004] The increasingly important field of software development brings 
with it the ever more common question - who can we get to actually do the 
software coding? Software developers or coders are in high demand, and their 
5 skills demand premium salaries. As such the software generation or 
development process is a major factor to consider for any company that relies 
on or uses software for it's day-to-day business needs. This issue is even more 
relevant to those companies who support the software development process - 
companies such as BEA Systems, Inc, IBM Corporation, and Microsoft 

1 0 Corporation who develop software development products, suites and tools. In 
order to maximize the benefits of their products to their end customers, these 
companies must develop tools that allow a software developer to minimize the 
amount of time necessary to finish a particular software project, while at the same 
time maximizing the options available to the developer to create a quality 

15 product. Some tools are also particularly geared to helping junior or beginning 
developers, who may not be as experienced, to successfully compete against 
more established and skilled software architects. 

[0005] Given the importance of software development to the global 
industry, and the demands that it should be relatively painless, easy to work with, 

20 and that it make optimal use of time and resources, it seems natural to want to 
develop a software generation tool or system, that automatically generates 
software code in accordance with some preset or preordained wishes of a 
developer. This allows the software architect or developerto concentrate on the 
"big picture", and to envisage the functioning of the software application as a 

25 whole, without undue regard to the intricacies of code development. 

[0006] To this end, many tools allow the software architect to develop a 
model or plan of the desired software application and to use this plan as a 
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blueprint for subsequent software development. Similar to the way in which an 
architect designs blueprints for a building, software architects or designers also 
design blueprints fortheir complex software applications. And just as a building 
architect likes to be able to test those blueprints for structural soundness, using 
5 for example a modeling or analysis system to test each aspect of the design, 
software architects also like to test their software blueprints for reliability, 
scalability, optimal use of resources, and good software design. As the 
complexity of a particular project increases, so too does the need for a reliable, 
accurate model. The software industry has developed several modeling 

1 0 techniques to address this need, one of which is the Unified Modeling Language 
(UML), a nonproprietary language defined in the Object Management Group 
Unified Modeling Language Specification, hereby incorporated by reference. 
UML provides software architects with a standardized language for specifying, 
constructing , visualizing and documenting the artifacts of a complex software 

1 5 system. The UML specification is a successor to three earlier object-oriented 
methods, Booch, Object Modeling Technique (OMT), and Object Oriented 
Software Engineering (OOSE), and includes additional expressiveness to handle 
more complex modeling problems, not readily handled by prior techniques. 
[0007] Some of the features inherent in UML are: Formal definition of a 

20 common object analysis and design (OA&D) metamodel to represent the 
semantic of OA&D models, including static, behavioral, usage and architectural 
models, Interface Definition Language (IDL) Specifications for mechanisms for 
model interchange between OA&D tools, which includes a set of IDL interfaces 
that support dynamic construction and traversal of a user model; and, easily 

25 readable notation for representing OA&D models, most commonly a graphic 
syntax for consistently expressing UML semantics. As such the UML is more 
correctly considered a visual modeling language rather than a visual 
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programming language. Because of its open standard and widespread industry 
use it serves to lower the cost of training and retooling when changing between 
projects or organizations, and provides opportunity for new integration between 
tools, processes and domains. 

5 [0008] UML is more correctly considered a visual modeling language 
rather than a visual programming language. Because of its open standard and 
widespread industry use it serves to lower the cost of training and retooling when 
changing between projects or organizations, and provides opportunity for new 
integration between tools, processes and domains. 

10 [0009] UML has served as the basis for many popular software 
development and modeling tools. One of these tools is "Rational Rose," an 
object-oriented tool produced by Rational Software Corporation (hereinafter 
simply referred to as Rational), which was originally designed for developing 
embedded technical and business applications based on the Booch 

1 5 methodology. Rational Rose supports UML, and is Rational^ primary offering 
in support of component-based development (CBD) at the enterprise level. 
Rational Rose provides the features and extensions necessary to support 
enterprise-level CBD and object-oriented analysis, modeling, design, and 
construction (OOAMDC) functionality. To allow the tool to operate with other 

20 tools in an enterprise development environment Rational Rose provides 
significantly enhanced support for integration with Rational^ and other 
manufacturers development tools, such as Visual Basic and Visual Studio, both 
from Microsoft Corporation. 

[001 0] Recently, the demand has arisen to incorporate the functionality of 
25 such modeling tools into the application server development field. One such 
application server is "M3" from BEA Systems, Inc., also known in several variants 
as "Weblogic Server" or simply "Weblogic." M3 (and Weblogic Server) are 
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enterprise level application servers or transaction servers that allow IT 
organizations to develop, deploy, and manage component based applications 
while building upon and leveraging existing environments and applications. No 
other system successfully tackles the demand for an integrated application 
5 development and modeling system for application servers. 

[0011] As used herein, the term M3 is used to refer to a specific 
embodiment of the invention. It will be evident to one skilled in the art that the 
invention may be equally used with other application , transaction and enterprise 
servers beyond M3 

1 0 [0012] Some tools have attempted to combine the design aspects of a 
UML-based design system, with code generation functionality, to better assist the 
software developer in code design and generation. An example of this type of 
tool is the Builder range of products from BEA Systems, I nc, San Jose, CA, that 
can be used to build software applications, primarily in C or C++, and primarily 

1 5 for the Tuxedo server product, although other types of application can be built, 
and in other languages. 

[001 3] A problem with most of these types of product are that they tend to 
be proprietary in nature, or are geared specifically toward code generation for 
a particular species of code type or server. If the developer or architect must 

20 work across platforms on a particular project they often need to learn the specific 
code generation techniques for those platforms. This in turn consumes 
development time, and adds to both the learning and maintenance time required 
to manage the various platform tools. The overall situation ends up being not 
much more useful than the situation in which no tools were used. 

25 [0014] An important aspect of developing new software development tools 
and software design products is to envisage how the design process and 
software code generation process can be successfully incorporated so as to 
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maximize the ability of the developer to quickly and easily build complex 
applications. 

Summary: 

5 [0015] As used herein, the term "M3" is used to refer to a specific 
embodiment of the invention. It will be evident to one skilled in the art that the 
invention may be equally used with other application , transaction and enterprise 
servers beyond M3. 

[0016] Roughly described, the invention provides an environment that 

10 incorporates a Rational Rose compatible UML design tool within a software 
application design and development product, to comprise an integrated software 
application, development, and modeling system. One embodiment of the 
invention can incorporate a software code Generator Framework to automatically 
generate code related to the design. This software code Generator Framework 

1 5 is described in further detail in co-pending application "SYSTEM AND METHOD 

FOR COMPUTER CODE GENERATION", Application No. , Inventors 

Todd Little, Loren Konkus, Gilles Lavalou and Timo Metsaportti, filed October4, 
2001, incorporated herein. It provides a common set of standards and 
application programming interfaces (APIs) to generate code and configuration 

20 files from any data source. A primary goal in developing the Generator 
Framework is to unify the code generation techniques implemented in the Builder 
family of products, by introducing sufficient abstraction levels. Built-in (or generic) 
rules are introduced in the generator framework. A data navigation layer isolates 
the generatorframeworkfrom the data sources used. Filters can be added to the 

25 framework to transform data. Notifiers are used by the generator framework to 
notify external components about the generation process. 
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[001 7] The Generator Framework is intended to be used in development 
products such as those produced by BEA Systems, Inc. which includes their 
Builder family of products. BEA Builder is designed to enable companies to 
leverage the development skills of their existing programming staff, while 
5 substantially reducing the time and costs associated with implementing new 
applications, such applications being then used primarily for the BEA Tuxedo 
platform. BEA Builder is a suite of products which address the key aspects of 
client-side and server-side application development. These include: 

BEA Active Expert - A tool that allows the use of popular Windows 
10 development tools to create BEA TUXEDO client applications. 

BEA C++ Expert - A tool that assists the programmer in writing BEA 
TUXEDO servers and clients using C++. 

BEA Contract Repository - A central repository for the storage of interface 
information for server-side BEA TUXEDO application components. 
1 5 BEA Configuration Expert - A tool to quickly and simply generate BEA 

TUXEDO configuration files without having to know the specific configuration file 
formats. 

[001 8] As described herein, the invention provides a new suite component 
20 or product, referred to herein as BEA Rose Expert. BEA Rose Expert (otherwise 
referred to as the "Expert System") is a plug-in to the Rational Rose development 
tool that allows the application designer to leverage the Rose object design 
environment to build BEA TUXEDO servers and clients using C++. It will be 
evident to one skilled in the art that other variants of the Expert System 
25 described herein can be developed to work with object design environments, 
and that such systems and tools are within the scope of the invention. 
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Brief Description of the Figures: 

[0019] Figure 1 shows an integrated software development system in 
accordance with an embodiment of the invention. 

[0020] Figures 2-3 show screen shots of an integrated software 
5 development system in accordance with an embodiment of the invention. 
[0021] Figure 4 shows options for use with the Expert System in 
accordance with an embodiment of the invention. 

[0022] Figure 5 shows a typical multi-cycle software development 
process. 

10 [0023] Figure 6 shows a software development process used by the 
Expert System in accordance with an embodiment of the invention. 
[0024] Figure 7 shows a flowchart of the software development process 
used by the Expert System in accordance with an embodiment of the invention. 
[0025] Figures 8-13 show screen shots of an integrated software 

1 5 development system in accordance with an embodiment of the invention. 

[0026] Figure 14 shows a flowchart of the code generation process used 
by the Expert System in accordance with an embodiment of the invention. 
[0027] Figures 15-23 show screen shots of an integrated software 
development system in accordance with an embodiment of the invention. 

20 [0028] Figures 24-28 illustrate the use of various design patterns as used 
by the Expert System in accordance with an embodiment of the invention. 

Detailed Description: 

[0029] In accordance with the invention, a modeling development system 
25 which uses UML object modeling is described. An example of such a system is 
referred to herein as the 'M3 Builder Rose Expert System" product from BEA 
Systems, Inc., San Jose, California. The M3 application server product, part of 
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the Weblogic family of products from BEA Systems, is just one example of an 
application server ortransaction serverthat can be used with the invention. It will 
be evident to those skilled in the art that the invention may be equally used with 
other application, transaction and enterprise servers and in other environments 
5 that require software development and modeling tools. 

[0030] The M3 Rose Expert System (hereinafter referred to simply as the 
Expert System) software product comprises a Rational Rose add-in or plugin 
that aids in the development of M3 Servers or applications in both Java and C++ 
that can then execute on all supported M3 platforms. This support includes: 
1 0 • The modification of an application Rose model to conform to certain M3- 
friendly design patterns. 

The generation of Java and C++ implementations for an M3 server 
described by a Rose model. 

The in-place modification of generated Java and C++ implementations 
15 to reflect Rose model changes. 

The generation of project support files, including interface definition 
language (IDL) files, and any necessary makefiles. 
The generation of an application test client to verify the integrity of the 
generated code. 

20 

[0031] The Expert System is designed to work with Rational Rose, a 
software design environment available from Rational Software Corporation, 
although other types of component-based development systems, particularly 
other flavors of object-oriented or UML design tools, can be used without 
25 departing from the spirit of the invention. 
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Definitions of Terms, Acronyms, and Abbreviations 
[0032] Design Pattern - A Design Pattern names and identifies a common 
object oriented design structure. The Expert System includes Design Patterns 
that improve an application's integration and performance in an M3 environment. 

5 

I DL- Interface Definition Language, as defined by the Common Object Request 
Broker Architecture and Specification. 

Interface Repository - The interface repository (IFR) contains the definitions of the 
10 interfaces that determine the CORBA client/server contracts. The interface 
repository has an associated RepositoryServer (which is an M3 server) which 
implements the CORBA repository interface. 

M3 - An application or transaction server, and its equivalents. 

15 

M3 Server- An executable program or application that implements distributed 
CORBA objects for use by client programs. 

M3 Application - A set or plu rality of one or more M3 servers that are started and 
20 administered as an entity and provide related services to clients. A configuration 
file (e.g. TUXCONFIG) is typically used by a boot program to start all of the 
elements related to the application describes an M3 application. 

Rational Rose - A visual modeling tool from Rational Software Corporation which 
25 supports the modeling and iterative development of object oriented applications. 
Rose supports an Extensibility Interface that permits the integration of 
development tools into the Rose environment. 



Attorney Docket No.: BEAS-01057US1 SRM/KFK 
kfk/wp/beas/ 1057usl/1057usl. application* wpd 



Express Mail No.: EL670728809US 



11 

UML - The Unified Modeling Language is a diagrammatic notation for modeling 
object-oriented systems. 

Relational Table Class - A class construct that represents a table in a relational 
5 database. It contains column definition and get/set methods. 

Relational View Class - A class construct that represents a virtual table (usually 
called view) in a relational database. This construct is frequently used to build 
customized access. It contains column definitions which is based on one or 
1 0 more existing relational tables. 

Composite View Class - A class that represents a combination of relational table 
and relational view classes as an atomic operation. 

1 5 Data Entity Group - A Rose category (logical package) that contains a set of 
classes representing the functionally related entities such as relational table, 
relational view, and composite view classes. 

M3 Builder Data Entity Group - M3 representation of a data entity group that 
20 contains a set of data entity packages. 

Data Entity Package - A Rose category that contains classes generated by Data 
Entity Generation feature to enable persistent handling of an M3 object into a 
relational database. 

25 

Object-Relational Mapping - The mapping of an object oriented database 
schema into a relational database schema. 
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Relational-Object Mapping - The mapping of a relational database schema to an 
object oriented database schema. The Data Entity Generation facility of The 
Expert System is focused on this mapping. 

5 General Expert System Description 

[0033] The Expert System software product allows M3 server developers 
to easily use Rational Rose to model their application and to generate M3 
servers from their Rose models. Using the Expert System, developers can: 
Create a design model for an M3 application. 
1 0 • Generate data entity objects which map to databases. 

Validate that the model they have created can be used to create M3 
servers. 

Generate C++ or Java classes that implement the model they have 
created. 

1 5 • Generate the supporting project configuration, definition, and build files 
that are necessary to build and deploy the application. 
Generate test client implementations to verify their implementation. 

[0034] Features of the Expert System product are not tied to a particular 
20 modeling tool like Rational Rose. Specifically, its features and concepts are 
portable to other tools including, for example, Select Enterprise. Code 
generation can be leveraged into other modeling tools, and can be used to 
support other server platforms. 

[0035] Supports development both in a Windows-only environment and 
25 in a Windows workstation /UNIX server environment including Rational Rose on 
Windows 95 and NT. 

[0036] Supports integration with the M3 Builder ActiveX Client, via 
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generation of M3 IDL source, which can then be used by the ActiveX Client. 
[0037] Supports integration with the M3 Builder Configuration Expert, and 
can leverage UML deployment diagrams to provide the Configuration Expert with 
additional UBBCONFIG information. 

5 [0038] H ides the usage of M3 1 DL from customers that are not interested 
in using IDL. It generates IDL from model classes and provides an automated 
interface to the M3 IDL compiler. It also provides an IFR browser so that 
customers can see the contents of the IFR. The Expert System generates IDL 
and automatically calls the appropriate M3 IDL compiler. An IFR Browser is 

10 available in the ActiveX Client Application Builder, which can be packaged with 
the Expert System inside M3 Builder. 

[0039] Provides a testing framework that generates default object 
implementations and test clients to exercise servers. 
[0040] Provides a dynamic sample code generation facility similar to the 
15 Builder C++ in areas where normal code generation is not appropriate. The 
programmer may cut & paste the sample code into their IDE. Such sample code 
is available in C++, Java, and VB. 

[0041] Support for regeneration of files where application logic has been 
implemented without losing the application logic. 
20 [0042] The Expert System add-in co-exists with other add-ins from other 
vendors. 

[0043] Ability to generate files/components (IDL, makefiles, ICF, servers) 
from theRose model to create M3 C++ servers. 

[0044] Supports the separation of an application's logical object model 
25 into different "views". The programmer is able to describe an "ideal" object 
model that represents the pure business objects and relates well to application 
use cases. The Expert System automates enhancing the ideal object model into 
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an "implementation" object model (called "model refinement") that describes all 
the actual classes in the implementation of the application. 
[0045] Supports "ideal" logical object modeling in an implementation 
language neutral form. 
5 [0046] The Expert System features supports and reinforces use of a 
high-level object oriented (00) development process such as the Unified 
Process. The system does not preclude the use of any 00 development process 
like Unified Process 

[0047] Supports modeling of all M3 IDL data types. 
10 [0048] Supports importing of standard CORBA IDL into a Rose model. 

This facility is needed to support porting of existing CORBA systems and 

exposing of non-M3 CORBA components in a model. 

[0049] Supports a powerful, flexible design pattern facility. This facility 

presents a library of good M3 design patterns and general industry design 
1 5 patterns that apply to M3. This facility also allows creation of new patterns. 

[0050] Support for very large modelsand complex application topologies. 

Designers may decompose their models using Rose control units and packages 

to help manage complexity and concurrency. Designers are free to create 

multiple IDL files which reference each other, and include selected CORBA 
20 Interfaces and data types within specific IDL files. In addition, designers are free 

to describe any number of M3 Servers and M3 Server Groups and associate 

implementation code with one or more Servers. 

[0051] Support for multi-user development of M3 Application models. 
[0052] Supports implementations using C++ and Java, including the ability 
25 to define the implementation language for an M3 application. 

[0053] In a Windows NT-only development environment, The Expert 
System supports integration with MS Visual C++ for C++ implementations and 
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Symantec Visual Cafe for Java implementations. Integration can take the form 
of generating project files and navigating from model classes to implementation 
code. 

[0054] The Expert System provides design patterns and code generation 
5 to map native C++ and Java language exceptions to CORBA exceptions. 
[0055] Due to large numberofexistingof RDBMS installations, the Data 
Entity Generation feature may include support for the relational-to-object 
mapping. 

[0056] Data Entity Generation provides the infrastructure to ease the 
1 0 object-to-relational mapping task. 

[0057] Data Entity Generation supports "ideal" logical object modeling in 
an implementation language neutral form. 

[0058] The system may assume that data entity classes in the Rose model 

map to a single RDBMS table. 
1 5 [0059] Support for easy mapping between M3 and RDBMS data types. 

Joins may be supported through the use of Relation View class. 

[0060] Provides for pattern design of data entities to work with existing 

data modeling products or methodologies in the Rose marketplace. 

[0061] Ability to generate DBTools API code initially, with ANSI 
20 Embedded SQL as the second target. 

[0062] Performance is the same as hand coded data entities. High 

performance of generated code. 

[0063] The data entity object interface is consistent across different 
RDBMS. Allows access to RDBMS specific features via extensions to the 
25 common data entity object interface. 

[0064] Expose XA functionality of the underlying RDBMS. 
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Product Functions 

[0065] Figure 1 shows an overview of a software development system in 
accordance with the invention. The software development system or product 
includes functions and features necessary to support the design, verification, and 
5 generation of M3 server applications. As shown in Figure 1, the complete 
development system 1 02 includes the Expert System 1 04 itself, and a version of 
the Rational Rose designer 1 06. The Expert System can be provided as a plugin 
into a Builder Generator Framework, as described more fully in co-pending 
application "SYSTEM AND METHOD FOR COMPUTER CODE GENERATION", 

1 0 Application No. , Inventors Todd Little, Loren Konkus, Gilles Lavalou and 

Timo Metsaportti, filed October4, 2001 , incorporated herein. The Rational Rose 
designer can be used to reverse engineer input database (RDBMS) files 108 
and input IDL files 1 1 0, for subsequent use in generating servers or applications. 
A UML model 1 1 2 is used to define the server model under design. When the 

1 5 design is completed to the satisfaction of the software designer or developer, the 
developer can generate the necessary output IDL files 1 1 4, which are then stored 
in an interface repository 1 1 6 for later use. A test client 1 18 or client application, 
and a server 1 20 or server application can also be generated . Together these 
generated client and server applications are used to comprise an integrated 

20 design or development environment (IDE) 102. 

[0066] The functionality of the Expert System is presented in this 
document from several different perspectives: 

[0067] User Interface: In one embodiment, the Expert System is a Rose 
add-in or plugin. This means that the Expert System presents its functionality to 
25 users in the form of menus, dialogs, message boxes, and design entity 
properties. 

[0068] Application Modeling Process: There is a logical workflow 
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surrounding the design and fabrication of M3 applications using Rose and the 
Expert System. 

[0069] Model Import Support: Many customers will be using existing 
databases and legacy applications in their new M3 applications. 
5 [0070] Data Entity Generation: This facility is designed to help M3 
software designers to easily access information available in existing relational 
databases. 

[0071] Design Pattern Support: The system encourages application 
developers to follow certain design patterns that leverage the characteristics of 

1 0 the M3 environment and foster the development of high performance transaction 
servers by including support for them in the Expert System. 
[0072] Design Model Verification: By checking a Rose design model for 
consistency and completeness before generating implementation code, the 
system can help to discover errors earlier in the development process where they 

1 5 are easier to repair. 

[0073] Source Code Generation: The Expert System applies certain 
mapping algorithms in the transformation of Rose logical and component views 
to generated Java and C++ server source code. 

[0074] The typical audience or user for the invention is a methodical 
20 software engineer embarked on a journey to design, model, and implement a 

large application. This new application will extend and interact with existing 

applications and databases. Because of the complexity of the application, the 

user has elected to use a software design tool to aid them in this process. 

Rational Rose is a typical selection, having the benefit of a good reputation 
25 among developers, strong third party support, and the availability of M3 server 

development tools supporting their language of choice. 

[0075] Suitably girded, the software engineer begins by enumerating the 
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application environment through use cases and abstract classes. Through 
research, the environment is captured in Rose and a logical model is divined 
which, if implemented, will fulfill the application's requirements. As the journey 
progresses, the model becomes more concrete until it contains sufficient detail 

5 that it can be realized as source code. 

[0076] The invention aids in this journey by providing tools that assist in 
the refinement and implementation of an application model. The Expert System 
includes import features that are used to fold existing application and database 
knowledge into the design model. Design Patterns and the Model Verification 

10 tools assist the software developer by performing much of the rote work 
necessary to complete a model for use within M3. Source code generation 
creates the implementation from the model and helps to keep the model and 
source code synchronized. The integration of the Rose model and the 
Configuration Expert aids the engineer in the deployment and configuration of an 

15 application. Together, these tools reduce the time necessary to turn a Rose 
application model into a prototype M3 Server and ultimately into a production 
quality implementation. 

User Interface 

20 [0077] The Expert System can be provided as a "plug-in" into the 
standard Rational Rose product. As such, the graphical user interface (GUI) for 
the Expert System is an extension of the Rational Rose user interface. During 
installation, a "BEA Rose Expert" option is added to the Rational Rose Add-In 
Manager, as shown in Figure 2 (1 40). With "BEA Rose Expert" selected in the 

25 Add-In Manager, the "BEA M3 Builder" menu option is added to the Rational 
Rose "Tools" menu, and the "M3 Builder" and "M3 Builder Data Entity" property 
tab is added to the Rational Rose property specification. 
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[0078] The resultant menu tree is shown in Figure 3 (142), the important 
features oroptions of which are further listed in Figure4. In using the application, 
selecting the "BEA M3 Builder" entry from the "Tools" menu 160 will lead the 
user to a sub-menu offering all of the functions provided by the Expert System. 
5 [0079] The New Project option 1 62 guides the user through setting project 
options and creating M3 Frameworks and/or Data Entity Frameworks in the 
logical view. M3 Framework is a logical package in the logical view, which 
contains all of the classes in the M3 Framework. Data Entity Framework is a 
logical package in the logical view, which contains a set of base classes from 
10 which all data entity classes must subclass from. If the "Enable Data Entity 
Generation" option is selected, a Data Entity Framework logical package in the 
logical view is created also. The terms "logical package" and "logical view" as 
they apply to the use of a Rational Rose product are well known to one skilled in 
the art. 

15 [0080] A New Model Element option 164 guides the user through creating 
a new model element. The element types include Constant, Enum, Exception, 
IDL, Interface, M3 Server, M3 Server Group, Module, RelationalTable, 
RelationalView, Struct, Typedef, and Union. 

[0081] An Import Model Element option 166 imports schema and data 

20 from the RDBMS database to the Rational Rose Model. 

[0082] An Apply Design Pattern option 1 68 applies design patterns to the 
user's application model. These Design Patterns modify the application model 
to improve its integration and performance in an M3 environment. 
[0083] A Prepare for Implementation option 170 finishes the current 

25 remaining design work. Any changes to the design after this step require 
Prepare for Implementation to be executed again. 

[0084] A Validate Model option 1 72 checks the model for consistency and 
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validity. Validation can not be performed when the model is being constructed. 
The programmer should run validation frequently, for example, every time they 
enter a new class or any significant amount of data. All of the validation 
information is written to the Rational Rose log window. 
5 [0085] A Rose Expert generate option 1 74 allows the Expert System to 
generate M3 compatible code for the application model. 
[0086] An Edit Implementation feature 1 76 uses the a notepad program 
or other text editorto open the files associated with the components selected in 
the component diagram. 
10 [0087] The developer or user can specify default values for Project 
Options 178. The values specified therein determine how the Expert System 
performs the creation of a new project, the model validation, and code 
generation. 

[0088] A Quick Admin feature 180 includes the following functions: Load 
15 Configuration, Build Application, Start Servers, Run Sample Client, Stop Servers 
and Configuration Expert. Load Configuration loads the configuration file to the 
system. Build Application invokes the project build file to build the application. 
Start Servers boots up the application servers. Run Sample Client invokes the 
sample client program. Stop Servers shuts down the application servers. 
20 Configuration Expert brings up the Configuration Expert application and M3 
Builder Tabs in Rational Rose Specification Dialogs. 
[0089] The Rational Rose interface includes specification dialogs forthe 
packages, classes, components, etc., that are used to define the attributes for 
these various items. I n addition to the dialogs accessible directly from the Tools 
25 menu, the Expert System also adds a "M3 Builder" tab to four of these Rational 
Rose Specification dialogs (Class, Component, Processor, and Component 
Package.) In Rational Rose, classes are created in the Logical View. Once 
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created, the details of the class can be defined in the Class Specification dialog. 
In Rational Rose, components are created in the Component View. Once 
created, the details of a component can be defined in the Component 
Specification dialog. In Rational Rose, component packages are created in the 
5 Component View. Once created, the details of a component package can be 
defined in the Component Package Specification dialog. 

Application Modeling Process 

[0090] A Model is an abstraction of the essentials of a complex problem, 
1 0 arrived at by filtering out the nonessential details, thus making the problem easier 
to understand. Visual Modeling is a way of thinking about problems using models 
organized around real-world ideas. Modeling promotes better understanding of 
requirements, cleaner designs and more maintainable solutions. Models help a 
developer to organize, visualize, understand express and create complexthings 
1 5 or solutions to complex problems. Successful modeling requires a notation, a 
process and a tool. 

[0091 ] For the visual modeling of M3 applications, one embodiment of the 
invention uses the Unified Modeling Language (UML) as the notation, an 
iterative-incremental development life-cycle based process, and Rational Rose 

20 Modeler as the tool . Since the Expert System product is designed as an add-in 
to the Rational Rose Modeler, the rational Rose modeling space forms the basis 
of the visual modeling of M3 servers. This section briefly discusses some of the 
conceptual aspects behind the rational Rose Modeler product in relation to the 
Rose Expert add-in (the Expert System), with special emphasis on the Rational 

25 Rose Modeler browser views that are used to design applications. 

[0092] The Unified Modeling Language (UML) is a visual modeling 
language supported by rational Rose for specifying, visualizing, constructing, and 
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documenting the artifacts of software systems, as well as for business modeling 
and other non-software systems. I n relation to the Rose Modeler, UML includes 
the following categories of information and associated types of diagrams: 
[0093] Use cases - Described by the Use Case diagrams in the Use 
5 Case View. The Use Case View of the Rose Browser provides an area to 
develop use cases, using packages, actors, use cases and use case diagrams. 
Use Cases are then ranked and scheduled. Scenarios for complex use cases 
may be developed. 

[0094] Static Model - Described by Class diagrams in the Use Case view 
o 1 0 and Logical View. The Logical view and the Use Case View in the Rose Browser 
^ provide an area to develop a logical view or representation of the system. The 

^ Logical view shows static structures, which consists of classes and the 

yg associations among them. 

J [0095] Dynamic Model - Describes the system behavior and illustrates 

15 events from actors to systems. Sequence diagrams and Collaboration diagrams 

O are created for use cases to identify system events and system operations. 

2 These diagrams are created in the Use Case view and in the Logical View, but 

.ff generally in the Logical View, since their creation is dependent on the prior 

development of the use cases. System behavior is a description of what a 
20 system does, without explaining how it does it. Behavior of classes are shown 
using State Diagrams, which are also a part of the Dynamic model. In the Rose 
Modeler the developer can create state diagrams for classes in the Logical View 
to depict their behavior and dynamic relationships. State diagrams apply to 
classes only. 

25 [0096] Implementation - Described in the Component View of the Rose 
Browser. It comprises component packages and task modules (or components). 
Components are used to depict the grouping of classes in the entities that 
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physically implement their instances. Component diagrams describe the 
relationships among the various components. 

[0097] The UML is a modeling language, not a method, and as such has 
no notion of process. Rational Software has merged their processes (Booch, 
5 OMT, OOSE) to create a result called the Rational Objectory Process. It will be 
useful to first look at a generic object-oriented (OO) development process and 
its phases, and then OOSE. OOSE is a use-case driven method, which has an 
interesting notion of the "Ideal Object Model". 

[0098] Figure 5 provides an overview of an iterative approach to object- 
10 oriented development. The essence of an iterative approach is that the 
developer develops an application by successive approximations. First they 
develop a core application - an initial prototype. Then they refine the prototype, 
improving and extending it. Depending on the complexity of the application, the 
development process may go through many cycles or iterations (illustrated by 
1 5 design cycles 1 86, 1 88, 1 90). 

[0099] Figure 6 illustrates an overview of a design process in accordance 
with an embodiment of the invention. Thedesign process includes the following 
phases: 

[0100] Requirements specification 194 - The first phase is unique 
20 because it begins with a requirements phase that precedes the analysis phase. 
There are many ways to do requirements analysis: Business Process 
Reengineering studies, scenarios, use cases, or CRC cards. This phase ends 
with a requirement specification - a document that provides an overall description 
of the application to be developed. 
25 [0101] Analysis 196 - In this phase, a variety of UML diagrams can be 
used. Some diagrams, for example, class diagrams and sequence diagrams, 
are used over and over throughout the development effort and keep getting 



Attorney Docket No.: BEAS-01057US1 SRM/KFK 
kfk/wp/beas/l 057 us 1 /l 057us Lapplication. wpd 



Express Mail No.: EL670728809US 



expanded and refined. Others, for example, state diagrams, are only used when 
the developer encounters particular problems needs to define a specific object 
or interaction in more detail. 

[0102] Design 198 - In this phase the focus shifts from the logical 
5 relationships between objects, to the physical layout of the system. The diagrams 
used in analysis are extended and information enhanced. Infrastructure objects 
are added to the business objects that were developed during analysis. In 
addition, user interaction screens are developed, and any other interfaces 
required by the system. In object oriented systems, serious "buy versus build" 

10 decisions are made during this phase 

[01 03] Implementation 202 - The next phase in the development cycle 
begins with the generation or production of code. During the design phase all of 
the objects in the system have been specified, and probably all of the attributes 
and most of the operations have been identified. In using the Expert System 

1 5 provide by the invention, the classes and names that have been created during 
the analysis and design phase become code elements during this phase. 
[01 04] Test 204 - The final phase in the cycle involves testing the code that 
has been produced to see if it functions properly. Depending on the nature of 
the first prototype, testing may be a formal affair or it may involve fielding a 

20 prototype application and determining how users react to it. 

[01 05] During the design process, those options used in the design phase 
1 98 can be fed back into the analysis phase 1 96 in a reuse or recycle step 206, 
while library classes, components and business objects can be reused (208) in 
the creation of UML diagrams. Designing complex software systems in Rational 

25 Rose requires the preparation of many different versions of the various types of 
UML diagrams. However, using the invention the developer does not have to 
develop all the possible diagrams in a single shot. Instead, they can begin by 
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creating a limited version of the planned system for the first iteration. Then they 
can refine and enhance the system in future iterations until they arrive at the 
planned system. 

[0106] Figure 7 shows a flowchart of a summary of the design process 
5 described above. As shown therein, in step 210, the developer creates a 
requirements specification with use cases. In step 21 2 an analysis is performed 
with class diagrams. In step 214, the design is generated and evaluated, and in 
step 216, the system is prepared for implementation. In step 218, code is 
generated and tested . I n step 220 options used in the design phase are fed back 
1 0 into the analysis phase for reuse. 

Use of the Invention to Model a Typical M3 Application 
[01 07] This section describes the first iteration of the process from the 
viewpoint of the server application developer, and defines the steps needed to 
15 develop a prototype of a M3 application. The example that follows uses an 
adaptation of a University-related basic sample application that is provided with 
the M3 software system, and is useful in illustrating the modeling steps. 

Requirements Specification with Use Cases 

20 [01 08] The developer produces the Main Use case diagram and other 
Use case diagrams as needed. This step is done in the Use Case View Folder 
of Rational Rose. A use case diagram provides a functional specification of a 
system and its major processes, and describes the problem that needs to be 
solved. Figure 8 shows a use case diagram 221 for our illustrative M3 University 

25 basic sample application. The goal is to create a M3 University course 
registration system that lets a student get a synopsis of all courses that are 
available to betaken, and the details of a specified list of courses. We document 
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each use case with the use case specification tool. Use cases that have a high 
rank are tackled in the first development iteration. 

Perform Analysis with Class Diagrams 
5 [01 09] Atthis point, the developer can convertthe use case diagrams into 
an ideal object model of the system. To do this, we examine the use cases to 
discover the classes it suggests. During the first pass, these classes would be 
specific to the problem domain. Based on these classes and their relationship 
to one another, we create class diagrams. The relationships between classes 

1 0 are shown as association lines. In Rational Rose, we can create class diagrams 
for each use case. Creating these class diagrams involves a series of steps and 
is done in the Logical View Folder of Rational Rose. Each major step can be 
captured as a separate logical package. These sets of logical packages 
(comprising collections of classes and/or logical packages) would constitute the 

1 5 ideal object model of the application. 

[0110] At this point in the process, the application designer has 
completed the external system interactions in terms of Use Cases and a big 
picture of the application in terms of the various Use Case diagrams and Class 
diagrams. This ideal object model is then stored as one or more separate Rose 

20 Control Units (.cat files). 

[0111] This phase illustrates an important process of inventing new 
classes, which are not visible directly in the problem domain. These classes are 
generally called Controller classes and encapsulate control flow logic. In this 
case, the Registrar class is a new class that we have introduced in this manner. 

25 We will use the stereotype of M3 Interface to highlight these classes in our model. 
Rose classes of the M3 Interface stereotype and the other stereotypes supported 
by The Expert System can be created using the Create Model Element menu of 
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The Expert System. Figure 9 shows the class diagram 224 for a 
GetCourseDetails use case. 



Design 

5 [0112] Inthedesign phase, we work mainly in the Logical View of Rational 
Rose to extend and add information to the diagrams produced in the analysis 
phase. The notation does not change as we move from analysis to design and 
iteratively back and forth to some extent. The main steps in this phase are: 
1 . Create class diagrams for the packages created in the Logical view 

1 0 2. Create classes and define their stereotypes, attributes and operations 

3. Apply Design Patterns codified for M3 applications 

4. Create component packages, components and component diagrams in 
the Component View of the Rose Browser. Component packages contain 
components, which are either IDL modules or M3 servers. Setting the 

1 5 GeneratelDLModule property to true in the IDLtab produces an IDL module. M3 
Servers are specified by setting the component stereotype to M3 Server. 
Components contain interface classes. This is done by assigning interface 
classes in the component specification dialog. 

5. Complete the design process using The Expert System menu command 
20 "Prepare For Implementation". 

Prepare For Implementation 

[0113] This step is available as a sub-menu of the M3 Builder menu under 
Tools in the Rose toolbar. It finishes the design work remaining after the prior 
25 steps outlined above have been done. Any changes to the design done afterthis 
step would require this step to be executed again. The first step in the design 
process can be performed by a New Project wizard, which creates the 
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M3Framework logical package that contains the base classes of the TP 
framework and the Data entity framework, some parts of which are shown in 
Figure 10 (228). The following operations are performed as a part of Prepare 
For Implementation: 

5 1 . As shown in Figure 1 1 , a logical package with the name C++ Binding 
232 (or Java Binding, depending upon the implementation language) is created 
at the same level (in the browser tree view) as that of a CORBA interface . The 
language specific package contains a class for every interface class( at that 
level) in the ideal object model and for those classes which have been 

10 externalized by the way of a relevant design pattern being applied on it. The 
name of this generated class is the same as that of the interface class with a 
suffix of j. I nterface classes that belong to the M3 Frameworks package are not 
included. This class represents a language specific implementation class for a 
CORBA interface class. M3 server modules realize these implementation 

1 5 classes. The operations of this class are obtained by applying the mappings from 
CORBA idl to the implementation language. This class can be edited by the user 
to include information that is not exposed to the external world through the 
corresponding interface class. These edits are maintained across multiple 
invocations of the prepare for implementation feature. If the user adds new 

20 operations to or changes an operation in the interface class, this feature updates 
the implementation class. 

2. In the Component View of the Rose Browser, it creates a component 
package called Interfaces with a single component whose name is the project 
name This component has a language of CORBA. This IDL module contains 
25 interface classes that have not been defined by the user but not assigned to any 
other IDL module. This module has files assigned to it to enable navigation to the 
generated IDL file. It also allows navigation to the generated client stub source 
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files. 

3. In the Component View of the Rose Browser, it creates a component 
package called <Project name>ServerPkg. It has a stereotype of M3 
ServerGroup. It contains a single component with name <Project name>Server. 
5 This component has a stereotype of M3 Server and a language which denotes 
the chosen implementation language (C++ or Java). This module contains 
interface implementation classes that have not been assigned by the user to any 
other M3 Server module. This feature enables quick modeling of prototype 
solutions. 

10 4. As shown in Figure 12, it creates another component package named 
ConfigAnd Build 234. This package contains a component which represents the 
project level source, configuration, and makefiles. It contains another component 
representing a simple ubbconfig file that is also generated during the code 
generation phase. 

15 5. It creates a component diagram called M3 ServerGroups in the 
component view that is used to show the relationships between the various 
server groups in the application. 

6. For each CORBA IDL module, it adds files corresponding to the 
generated IDL file and the client stub file, which are produced by compiling the 

20 IDL file using an IDL compiler. This allows easy navigation to the IDL file and the 
client stubs. 

7. For each M3 server module, as shown in Figure 13, it adds files 236 
which hold the servant class implementation files and the makefile used to build 
the M3 server. This allows easy navigation to the implementation f iles that have 

25 to be written for the server. 

[0114] Although the simple example given above describes a University 
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application, it will be evident to one skilled in the art that the features and 
processes described can be applied to other applications while remaining within 
the spirt and scope of the invention. 

5 Data Entity Generation 

[0115] Many enterprise-level software developers would like to take 
advantage of object technology to achieve high level of reusability, thus reducing 
overall development cost. However, to ensure a level of persistence, they may 
rather use a popular relational database system (RDBMS) which is mature, 

1 0 robust and proven at the enterprise level. Unfortunately, the task of mapping an 
object technology to relational databases is nontrivial and time-consuming. 
[01 1 6] The Data Entity Generation feature of the Expert System defined 
by the invention is designed to help software developers (and particularly M3 
customers) to easily create an object layer for access to popular RDBMSs. As 

1 5 such, it provides a relational-to-object mapping (existing relational tables are 
mapped to objects). Using this facility to create objects to encapsulate RDBMS 
access provides M3 customers with several benefits: 
[0117] It promotes reuse of code, thus improving productivity. 
[01 1 8] It reduces the number of programmers who need to be proficient 

20 with RDBMS access languages such as embedded SQL or proprietary 
procedural APIs. 

[01 1 9] It reduces the amount and complexity of RDBMS-related coding 
in an M3 application. 

[0120] For each relational entity such as a table or a view, the generator 
25 creates two C++ classes: The base class, which maps directly to the relational 
table, comprises of attribute (column) definitions and get/set methods; and the 
row level access class which provides atomic operations such as create, read, 
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update, and delete at row level. 

[0121] The Data Entity Generation can create source code that uses the 
Rogue Wave DBTools.h++ API to perform RDBMS operations. This makes the 
generated code easier to enhance and allows support of a wide variety of 
5 populardatabases such as Oracle, Sybase, Informix, DB2, and SQL Serverfrom 
a single source base. 

[01 22] There are several ways the programmer can extend the generated 
code: Add custom code to the "protected areas" in the generated "base" 
classes. These addition will be preserved when the classes are re-generated; 

10 and Generate subclasses from the generated base classes and provide 
additional processing logic or override generated methods. Using these various 
ways to extend the generated code, the programmer can leverage it to effectively 
cover all types of RDBMS access used in an M3 application. 
[01 23] The Rose98 Enterprise edition provides a database access add-in 

15 to address object-relational mapping and how to create persistent model 
elements from an existing schema. This add-in uses stereotype to categorize 
class constructs. The Expert System Data Entity Generation follows this add-in 
mapping technique and class constructs very closely, and wherever possible, it 
will reuse the pre-defined stereotypes to represent similar class construct. 

20 However, to avoid dependency on these pre-defined stereotypes, the Data Entity 
Generation introduces a property named "ClassType" in the "M3 Builder Data 
Entity" tab. The code generation is based on this property value so it is 
imperative that the property be populated with the appropriate class type. The 
Data Entity Generation feature can be used in modeling an M3 application. 

25 [01 24] For ease of illustration, the University sample application is used 
to demonstrate the detailed modeling steps involved. Figure 14 is a flowchart 
showing the steps required to model the application. The steps of Figure 14 can 
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be considered sub-steps of the generate and evaluate design step 2 1 4 of Figure 
7. As shown in Figure 14, the steps are as follows: 

Create Data Entity framework (step 302) 
5 [0125] To create the data entity framework, the programmer invokes the 
Expert System " M3 Builder => New Project. . ." menu option. This will, by default, 
create the Data Entity Framework category in the Rose model. This framework 
contains a set of base classes from which all data entity classes must subclass 
from. The existence of this category is used in the Data Entity Generation model 
10 validation. 

Create Data Entity Group(s) (step 304) 

[01 26] As shown in Figure 1 5, the data entity groups 238 are created by 
invoking the Expert System " M3 Builder => Import Schema..." menu option. 

1 5 Data entity groups represent the logical data model for the application. Each 
data entity group contains a set of relational table and relational view classes 
which represent RDBMS tables and views and any customized access definition. 
In the Expert System environment, a data entity group is represented as a Rose 
category (or package in Logical View) with the "ClassType" property and 

20 stereotype set to "Data EntityG roup". Because the University sample is rather 
simple, we will only create one data entity group named "UniversityDEG" to hold 
all data entities. For a more complex system, it is recommended that the 
programmer modularizes the data entities into subsystems and create data entity 
groups to represent these sub-systems. 

25 

Create customized access classes (step 306) 

[01 27] To accommodate customized data access, the programmer can 
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create custom access classes 240, illustrated in Figure 16. In step 306, the 
programmer creates the relational table classes and a class diagram to showthe 
relationship between them. A utility may be provided to import these entities 
from the RDBMS into the model. Customized access definition can be defined 
5 as well. These are created by defining relational view or composite view classes 
in the data entity group. 

Create Composite View Class (step 308) 

[0128] Composite view class deals with multiple table operation. The 
1 0 "AddCourseAndStudent" class will add one entry in the Course and one in the 

Student table. We use dependency to represent the relationship between a 

composite view class and the relational table classes involved. 

[0129] As mentioned, both the stereotype and "ClassType" property value 

236 are set to "CompositeView". And we also see that the Entities property is 
15 setto "COURSE;STUDENT"to indicate that this class will interact with these two 

entities. The "Updatable" property 238 is setto "True" to indicate that database 

update is allowed for this class. 

Relational View class (step 310) 
20 [01 30] To build customized access other than composite view class, the 

programmer creates relational view classes 242, as shown in Figure 17. Each 

relational view class represents a standard construct for creating a virtual table 

based on one or more existing relational table classes. 

[0131] For the University application, we create three relational view 
25 classes: CourseSynopsis, CourseDetail, and RegisteredCourses. The 

CourseSynopsis and CourseDetails are special views of the Course table. The 

RegisteredCourses is a joined query class. 
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[01 32] Again, the "ClassType" property value should be the same as the 
stereotype, which is "RelationalView". 

[0133] Fora relational view class which composes of columns from more 
than one table (multi-table view which traditionally represents a joined query), the 
5 "Updatable" property value is set to "False". 

[0134] For an RDBMS, a multi-table view is not updatable. However, for 
future releases of ORDBMSes, it is very likely that the programmer can update 
a multi-table view. 

10 Apply Data Entity pattern (step 312) 

[01 35] After creating the data entity group(s), the programmer invokes the 
" M3 Builder => Apply Design Pattern..." to generate/update the M3 
representation and implementation of the persistent model defined as shown in 
Figure 1 8 (244). The programmer can apply the Data Entity pattern to either a 

1 5 data entity group or a relational entity. The following will happen: 

[01 36] A logical package is created for each data entity group if one does 
not already exist. Each package is the M3 representation for the defined data 
entity group and has the same name as the original data entity group prefixed 
with "M3". For the University example shown in Figure 19, a logical package 

20 named "M3UniversityDEG" 246 is created. 

[01 37] For every relational table, relational view, or composite view class, 
a data entity package is created in the M3 Builder data entity group 
representation as shown in Figure 20. For example, the CourseDEP 248 is 
created to represent the Course table. Inside this data entity package, a class 

25 diagram, a relational entity and an access class are created. The class diagram 
represents the actual pattern being applied to the relational entity. The relational 
entity named CourseRT contains the actual column representation and get/set 
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methods (which are not shown). The access class named CourseDEA holds the 
interface to the relational base class. 

[01 38] The class diagram show the relationship of the generated classes 
and the classes coming from the framework. In general, this is the pattern that 
5 we use to handle the RDBMS-Object mapping for The Expert System. 

[01 39] This step involves creating/updating the equivalent M3 Builder data 
entity group(s) in the Logical View. Each generated M3 Builder data entity group 
contains a set of data entity packages which map to the relational table and 
relational view classes. The M3 Builder data entity group has the "ClassType" 
1 0 property and stereotype set to "M3DataEntityGroup". The package name is the 
same as the data entity group prefixed with "M3". Foreach relational table class, 
a data entity package is created inside the corresponding M3 Builder data entity 
group. This data entity package has "ClassType" value and stereotype of 
"M3DataEntityPackage". This data entity package contains the following: 
15 • A class diagram which depicts the relationship of the relational table 
class, its access class, and some of the Data Entity Framework classes. 
The relational table class which is a direct mapping of the relational table, 
get/set and support methods. This class has "ClassType" property and 
stereotype of "RelationalTable". 
20 [0140] The access class which provide row-level basic operations such 
as create, read, update, and delete. This class has "ClassType" property and 
stereotype of "DataEntityAccess". 

[0141] For each relational view class, a data entity package similar to 
those for the relational table classes is created. The only difference is that 
25 instead of having the relational table class, we now have the relational view class. 
This class has the "ClassType" property and stereotype of "RelationalView". 
This is another Rose Oracle8 add-in stereotype. 



Attorney Docket No.: BEAS-01057US1 SRM/KFSC 
kfk/w]ybeas/l 057usl/l 057usl . application, wpd 



Express Mail No.: EL670728809US 



36 

[01 42] For each composite view class, a data entity package similar to 
those for the relational table classes. The only difference is that instead of having 
the relational table class, we now have the composite view class. This class has 
the "ClassType" property and stereotype of "CompositeView". 

5 

Prepare for Implementation (Step 313) 

[01 43] The next step is to prepare the model for implementation. This is 
done by invoking " M3 Builder => Prepare for Implementation...". This step 
involves creating the M3 data entity groups in the component view. All 

10 implementation details such as physical source files, make files, libraries are 
populated in all corresponding model components. 
[0144] Once the M3 data model has been created, the programmer 
invokes the" M3 Builder => Prepare for Implementation. . ." 250 (shown in Figure 
21) to create the physical representation of the data model in the Component 

15 View. However, this step will be automatically activated by the code generation 
process. 

[0145] A component package is created for each data entity group if one 
does not already exist. This component package represents the M3 
implementation for the defined data entity group and has the same name as the 

20 M3 logical representation. For the University example, a component package 
named "M3UniversityDEG" 254 is created, as shown in Figure 22. 
[0146] The"UniversityDEG" is the implementation component represent 
the generated classes in the form of a library. The programmer can set the 
"LibraryType" property to either "Static" or "Dynamic" to indicate whether the 

25 library should be static or shared, respectively. 
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Code generation (step 314) 

[01 47] The very last step in the process is code generation. This is done 
by invoking " M3 Builder => Generate...". The code generation involves 2 
separate processes: prepare for implementation and code generation. The first 
5 step is to prepare the model for implementation. This step involves creating the 
M3 data entity groups in the component view. All implementation details such as 
physical source files, make files, libraries are populated in all corresponding 
model components. The source files for each data entity group is generated in 
a separated subdirectory. 
1 0 [01 48] Once the modeling is done, the programmer would generate 256 
(shown in Figure 23) the data access code for the application. This process 
involves creation of directories if they do not already exist, and generation of data 
access C++ source, make files. 

[0149] By default, data access code for each selected component 
1 5 package (which map to a logical package with stereotype "Data Entity Group") 
is generated in a separate directory. 

Extensibility 

[0150] As mentioned previously, the programmer can extend the 
20 generated code in several different ways to provide very powerful and robust 
data access handling: 

apply changes to the template to achieve global effect, in other words, the 
changes are made to all generated data access classes, 
apply the modification into the protected code areas of a particularclass 
25 for changes that are local to a particular class. 

subclass from the generated classes and introduce the customized 
behavior in the subclass. This allows the generated class be re-used in 
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Design Pattern Support 

[0151] A Design Pattern names and identifies a common object oriented 
5 design structure. A popular definition of a pattern is that it is "a solution to a 
problem in a context", in which "context" refers to a recurring set of situations in 
which the pattern applies; "problem" refers to a set of forces - goals and 
constraints - that occur in this context; and, "solution" refers to a canonical design 
form or design rule that someone can apply to resolve these forces. 
10 [0152] The Expert System provided by the invention includes the 
capability to apply Design Patterns to a user's application model. These Design 
Patterns modify the application model to: 
Improve its integration 

Improve its performance in an M3 environment 
1 5 • Assist the designer in developing their model 

[01 53] Design Patterns as used in the Expert System are divided into 3 
broad categories. The first category is referred to as Core Patterns. These 
patterns utilize fundamental features of M3 that are required to build M3 
20 applications. Their intent is to ensure that the user's M3 application adheres to 
the required modeling conventions necessary to ensure that code is generated 
correctly. In general, the results of applying Core Patterns require little additional 
work on the part of the designer. 

[01 54] The second category of Design Patterns is called Helper Patterns. 
25 These patternstrytoassistthedesignerin modeling their application. They are 
called Helper Patterns because they tend to produce only a start of a design and 
require additional effort on the part of the designer to ensure that the design is 
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robust and scalable. In general, these patterns take some information from the 
model and produce new elements from that information. 
[01 55] The third category of Design Patterns is called User Patterns. The 
Expert System has the support necessary to add in new design patterns. These 
5 patterns, like all other patterns, can manipulate the Rose model, provide a user 
interface to collect information, and can participate in code generation. 
A developer may make use of this capability to develop patterns unique to 
particular industries or customers. 

[0156] Patterns may be applied to a Rose model by selecting a model 
1 0 element (typically a Class) and invoking the Pattern by using the menus in the 
Expert System. System developers and end-users or customers may add 
support for design patterns. System developers and customers may also add 
new design patterns to the Expert System. Design patterns are evolving as 
experience with them matures. As improvements are made to design patterns 
15 or new design patterns are discovered, it is desirable to have the Expert System 
support them. In addition, customers may have particular design patterns that 
are unique to their company or industry. 

[01 57] A user provided design pattern takes the form of a Java class that 
implements the DesignPattern interface. In addition to being able to manipulate 
20 the model through the application of a design pattern, users are able to modify 
or add their own templates and rules necessary to generate any code associated 
with the design pattern. 

Core Patterns - The Factory Pattern 

25 [01 58] There are several common patterns that may be used to create 
new instances of objects. M3 encourages the use of Factories in its architecture 
and implementation. Factories are object instances that create other objects. The 
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basis of Design Patterns and their use is further described in "Design Patterns: 
Elements of Reusable Object-Oriented Software" by Gamma et al., hereby 
incorporated by reference. 

[01 59] Factories are the primary means by which distributed objects are 

5 created in an M3 application. How the objects are created and how they are 
distributed across servers is largely determined by the factory that creates the 
instances and sets their associated object key. This pattern helps the designer 
in using the facilities provided by M3 to create object factories. The design 
created may need some editing and the developer may have to add code to the 

10 factory method implementation to initialize instances. 

[01 60] Factories produce instances that adhere to a specified interface. 
The operations that produce these instances are called factory operations. A 
factory can have one or more factory operations that prod uce instances for one 
or more interfaces. As each factory requires an object reference, it may be 

1 5 desirable to reduce the number of factories by having fewer factories that can 
create multiple kinds of instances. Factories can either produce new instances 
or find existing instances. Lookup operations that retrieve or find existing 
instances are typically associated with factories and can be added by simply 
adding those operations to the factory class. 

20 [01 61 ] The Expert System menu includes the ability to apply the Factory 
pattern to a specific class in the Logical View. This pattern has the following 
effect: 

1 . Creates a new Class. If being applied to a single class <class jiame> the 
new class will have the name <class name> Factory. If being applied to more 

25 than one class, the new factory will simply be called NewFactory. 

2. Populates the factory class with a factory operation named 
create_object() that returns an instance of <class name> if the pattern is being 
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applied to a single class. If it is being applied to multiple classes, a factory 
operation for each class will be added to the factory class with the name 
create__<class_name> returning an instance adhering to the <class_name> 
interface. 

5 3. Marks the factory class with properties to ensure that it is included in the 
generated IDL, and Java or C++ implementations. 

4. Marks the source class(es) so that it is also included in the generated IDL. 

5. Creates an association from the factory class to the source class(es) with 
the name Instantiates, as shown 274, 276 in Figures 24 and 25. 

10 6. If the source class is included in a Server, mark the new factory class to 
be included in that server. 

7. Causes factory registration code to be generated in any servers that 
include the factory class. 

[0162] After the application of this pattern, designers are free to further 
1 5 modify the constructor operation specification to include any necessary selection 
and initialization parameters. Applying the Factory pattern has the side effect of 
making both the source class and the factory class external. If a designer should 
wish to use this pattern in conjunction with a Distribution Adapter (DA) pattern, 
they should apply the DA pattern first and then the Factory pattern to the 
20 synthesized DA class. 

[0163] For servers including the factory class, the initialization code 
generated takes care of registering the servant and the factory. The 
create__object method implementation will be stubbed out with code to create a 
default IOR. Forfactory based routing, a class with a stereotype of M3 Routing 
25 defines the routing specification. The routing specification class has a single 
attribute that defines the field name, field type, and ranges, using the attribute 
name, attribute type, and initial value respectively. An interface that participates 
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in factory based routing has a property on the M3 Builder tab named 
FactoryRouting that specifies the name of the routing specification class. The 
code generated for a factory participating in factory based routing will create the 
NV list and leave a place for the userto add the routing criteria. For all factories, 
5 the necessary code to construct the I OR will be present, although the user may 
want to edit the way the object ID is constructed. 

The Distribution Adapter Pattern 

[01 64] The Distribution Adapter pattern may be applied to a local class 
1 0 in the application to create an Adapter class that will be exposed to M3 clients. 
The design pattern "Adapter" is described in several contemporary pattern 
books and is a term known to one skilled in art. 

[0165] An Adapter converts the interface of a class into another interface 
that clients expect. Application of the Adapter pattern does not necessarily imply 
1 5 the behavior of the new client interface. The resulting Adapter interface may have 
exactly the same behavior as the original, or it may be different. The Adapter 
pattern can be used in many situations: 

[01 66] When you are reusing an existing class and its interface doesn't 

match what you need. 
20 [01 67] When you need to interact with a non-object implementation using 

objects (the Wrapper pattern). 

[0168] When you want to create a reusable class that cooperates with 
other classes that have incompatible interfaces. 

[0169] Whenyou haveacomplexclassandyouwanttopresentasimpler 

25 interface to clients. 

[01 70] When you need to separate the client interface of an object from 

its implementation so each can evolve independently. 
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[0171] The Distribution Adapter pattern is a specialization of the Adapter 
pattern targeted towards the last situation. It specifies the creation of a 
specialized external interface for an implementation object that is specifically 
designed to be published and called by distributed clients. The client interface 

5 may have exactly the same interface as the implementation object, or it may be 
simplified or enhanced to optimize its network performance. 
[01 72] In an M3 application, it is necessary to determine which objects are 
distributed and visible to clients versus which objects are local language objects. 
The Distribution Adapter pattern allows the designer a means to formalize this 

1 0 distinction. Distributed objects need to have a well-defined interface, be made 
known to the M3 framework, and be appropriate for distribution. This design 
pattern addresses the first two of those attributes, but leaves the third up to the 
designer. The designer must still apply good d istributed object design principles 
and ensure that the object they are distributing is of appropriate weight, function, 

15 and visibility. 

[0173] In a distributed object system, not all objects must be made 
accessible from network clients. Local language objects are objects like 
instances of C++ classes that are meant to be used only within the context of a 
single program address space. The overhead to use them is extremely low. 

20 Distributed objects on the other hand carry an inherent overhead in using them 
due to crossing address space boundaries. In order to perform acceptably, a 
designer may choose which objects need to be accessible across process 
address space boundaries and ensure that the cost of invoking operations on 
these remote objects doesn't consume an inordinate amount of resources. Often 

25 a single distributed object will act on the behalf of many local language objects 
and their interfaces may in fact be quite different. It is up to the designer to 
carefully choose those objects that must be distributed and design their 
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interfaces for acceptable application performance. 

[0174] The Expert System menu includes the ability to apply the 
Distribution Adapter pattern to a specific class in the Logical View. This pattern 
has the following effect: 
5 1 . Creates a new Class for the selected class named DA<class name>. 

2. Populates the new Class with copies of all of the operations in the source 
class to serve as a starting point for the Distribution Adapter interface. 

3. Marks the new Class with properties to ensure that it is included in the 
generated IDL, Java, or C++ implementations. 

1 0 4. Creates a Distributes association 280 from the new class to the source 
class as shown in Figure 26. 

5. If the source class is included in a Server, mark the new DA class to be 
included in that server. 



1 5 [0175] After the application of this pattern, designers are free to further 
modify the implementation and DA class designs. No attempt will be made to 
reconcile these designs with each other. Should a designer wish to reconcile the 
designs, the DA class should be deleted and the DA pattern applied to the 
source object again. The servant initialization code for the distribution adapter 

20 is included in any servers that include the distribution adapter. Skeletons and 
stubs are produced for the distribution adapter class and methods. 



The Distributed Interface Pattern 

[0176] This pattern is nearly identical to the Distribution Adapter design 
25 pattern except that no new classes are created. The classes this pattern is 
applied to have the appropriate properties set to ensure that the class is included 
in IDL generation and has a servant class created for it. 
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[01 77] The user may already have a good three-tier design defined and 
may need to just add the necessary details to make it a good M3 design. This 
pattern allows the designer to mark a class as being distributed. No additional 
classes need to be created as the model already has the appropriate classes 
5 defined, but without the required M3 properties. This pattern sets those 
properties. 

[0178] It is important that the class this pattern is applied to be 
appropriate for distribution or client access. Applying this pattern to an entity 
class would move the business logic from the server to the client reducing the 
10 design for this portion of the application to a two-tier model. 

[0179] The Session pattern may be applied to a Rose class to create a 
Session class that will be exposed to M3 clients. A session class allows a client 
to establish a session with an application that will be used for some series of 
interactions. 

15 [01 80] The Session design pattern allows a client application to create an 
instance of an object that serves as a session with the server. In one 
embodiment, information is placed in the object I D that identifies the session to 
both the client and the server. In the M3 University Production example, the 
registrar nearly acts as an instance of a session. The ID of the student could 

20 have been placed in the object I D of the IOR instead of passing it along in each 
call to the registrar. This would eliminate problems such as using a student ID 
with a registrar that can't handle that student. 

[0181] There are times when it may be desirable for a client to maintain 
a session to a server. Although the client and server must still deal with all the 
25 issues associated with serverfailure and session re-establishment, the benefits 
of maintaining the session may outweigh the effort of dealing with those issues. 
An example may be where the server has to do a great deal of database access 
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in order to get the proper objects ready for the client and that the client must 
make multiple interactions with those objects. 

[01 82] This pattern allows the client to establish a session with a server 
that maintains state over more than one interaction. As a result, the server must 
5 now explicitly manage the state and readiness of the object. In addition, the 
server may fail between interactions and recovery for this must be included in the 
client application. 

[0183] The Expert System menu includes the ability to apply the Session 
pattern to a class in the Logical View. This pattern has the following effect: 
10 1. Marks the class with properties to ensure that it is included in the 
generated IDL, and Java or C++ implementations. 

2. Sets the appropriate properties to ensure that the activation policy is set 
to process. 

[0184] After the application of this pattern, designers are free to further 
1 5 modify the implementation and Session class designs. Typically, one would want 

to then apply the Factory pattern to the session class to create a factory. 

[01 85] The servant initialization code for the session class is included in 

any servers that include the session class. Skeletons are produced for the 

session class and its methods. Code and comments will be generated in the 
20 servant implementation and any factory methods for this class that indicate this 

interface maintains a session with the client and that the server needs to explicitly 

control the state of instances. 

Helper Patterns - The Process Entity Pattern 

25 [01 86] These patterns help the designer get started on the design of one 
or more classes. The designer may then alter the generated classes to fit the 
needs of the specific application. 
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[01 87] The Process Entity pattern may be applied to a Rose Entity class 
to help create a Process class that will be exposed to M3 clients. 
[0188] The design pattern "Process Entity" is described in the M3 
documentation. This pattern is well suited to 3 tier computing environments. 

5 [01 89] The Process Entity Pattern tries to assist the designer in designing 
the process objects. The assumption is that the entity objects will already exist, 
eitherthrough other modeling work, orby way of import from a persistent storage 
facility. As the starting point is one or more entity objects, there is little in the way 
of semantic knowledge available to the Process Entity Pattern to guide the 

1 0 designer in the creation of the process objects. This means thatthe pattern can 
either provide an empty class to the user, which in that case the new class button 
provided by Rose is sufficient, or the pattern can gather whatever information is 
available in the entity objects and populate the process object as a starting point. 
The designer may alter the class created by applying this pattern. 

1 5 [01 90] The Process Entity design pattern tries to help the designer focus 
the design on objects that perform high value operations on behalf of the user. 
Instead of having the client application directly manipulate entity objects, the 
process entity model suggests that the process objects operate on the entity 
objects. This saves the time and resources necessary to move the entity object's 

20 state to the client. It also hides or encapsulates the business logic from the client 
by placing that in the process object's implementation. The operations provided 
by the process objects should closely map to the business processes the 
application is providing. The Process Entity design pattern doesn't manipulate 
the model, but instead acts as a validator and tries to ensure that the process 

25 class doesn't violate the spirit of the process entity pattern. Specifically, during 
validation, the pattern will check to see if any attributes have been defined for the 
class and if so, flag them with an error. 
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[0191] The Expert System menu includes the ability to apply the Process 
Entity pattern to one or more process classes in the Logical View. This pattern 
has the following effect: 

[0192] It marks the classes as process classes, meaning they will 
5 participate in model validation. 

[0193] After the application of this pattern, designers are expected to 
further modify the Process class design. 

[0194] In one embodiment, no code is generated as a result of applying 
this pattern. During model validation, the class will be checked to ensure that it 
10 doesn't have any attributes or other properties that are inconsistent with the 
process entity pattern. 

The Proposal Manager Pattern 

[0195] The Proposal Manager Pattern may be applied to a Rose class to 
15 create a new class that provides methods to access an object's state and 
propose updates to that state. This new class will be exposed to M3 clients. 
[01 96] This design pattern provides a means to access entity objects from 
a client in a controlled fashion. A common use for this pattern is to allow a 
complex stateful object to be obtained by the client from the proposal manager, 
20 allow the client to manipulate the state of the object, and then propose the 
changes in state back to the proposal manager. 

[0197] There is a class of applications that need to allow a client to 
access and manipulate the state of a complex object. A loan application would 
be a good example. The loan application is obtained from the proposal 
25 manager, manipulated by the user within the client, and then the updates are 
proposed back to the proposal manager. The proposal manager is responsible 
for ensuring that the update is valid. 

Attorney Docket No.: BEAS-01057US1 SRM/KFK 

kfk/wp/beas/1057usl/1057usLapplication.wpd Express Mail No.: EL670728809US 



[0198] State management needs to be controlled by the proposal 
manager. It is conceivable that more than one client may want to access and 
potentially propose updates to the same object. Explicit locking, especially held 
over a long period of time, tends to have a severe impact on application 

5 performance and scalability. It can also be error prone or adversely affected by 
faults in the network or application. As a result, it is likely that the proposal 
manager will not maintain a lock on the objects being managed, but instead 
evaluate the proposed changes against the current state of the object and 
determine whether to accept the proposal or not. How this is done is application 

1 0 specific and left up to the implementation of the proposal manager class. 

[0199] The Expert System menu includes the abilityto applythe Proposal 
Manager pattern to a class in the Logical View. This pattern has the following 
effect as further shown in Figure 27. 

1 . Creates a new class from the selected class named PM<class name> 
1 5 that will be the proposal manager used to access and update the source class. 

2. Creates an association named Updates 292 from the proposal manager 
class to the source class. 

3. Creates a new class Struct<class_name> as a CORBA structure that will 
hold the source class's state. 

20 4. Creates an association named Serialized 294 from the source class to 
the data structure class. 

5. Populates the proposal manager class with the read and propose 
operations. 

6. Marks the proposal manager class and structure class with properties to 
25 ensure that they are included in the generated IDL, and Java or C++ 

implementations. 

[0200] After the application of this pattern, designers are free to further 
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modify the proposal manager class by adding, removing, or modifying 
operations. 

[0201] The servant initialization code for the proposal manager is included 
in any servers that include the proposal manager. Skeletons are produced for 
5 the proposal manager class and skeletal implementations are generated for the 
read and propose methods. 

The Entity Manager Pattern 

[0202] The Entity Manager Pattern may be applied to a Rose class to 

1 0 create a new class that provides methods to access the object's state by passing 
the state in structures. This new class will be exposed to M3 clients. 
[0203] This design pattern provides a means to access entity objects from 
a client in a controlled fashion. The most typical use for this pattern is in the 
development of table maintenance or other administrative programs. As the 

1 5 entities are exposed directly to the client, any client application that uses these 
manager classes will need to be carefully controlled. 
[0204] In the Entity Manager Design Pattern, an entity object has its state 
made available to a client by means of operations that allow retrieving and 
updating the object's attributes via structures. 

20 [0205] Many applications store their persistent state in relational 
databases. Although the provider of the database most likely will have tools to 
manipulate entries in the database, they may not be distributed or have the same 
sort of access control that the rest of the application is using. Using the Entity 
Manager Design Pattern allows access to the underlying entity objects, but still 

25 using the M3 infrastructure. 

[0206] This pattern assumes that all the state associated with an entity 
class is represented by the attributes for that class. This will be true for classes 
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created by importing database schema information, but not necessarily true in 
the general case. The designer may ensure this pattern is applied appropriately. 
[0207] The Expert System menu includes the ability to apply the Entity 
Manager pattern to an entity class in the Logical View as shown in Figure 28. 
5 This pattern has the following effect: 

1. Creates a new CORBA structure for the selected class named 
Struct<class name> that will be the structure used to pass the entity class's state 
between the client and server. 

2. Populates the data structure class with all the attributes from the entity 
10 class. 

3. Creates an association named Serialized 304 from the entity class to the 
data structure class. 

4. Creates another new class for the selected class named EM<class 
name> that will act as the entity manager for the entity class. 

1 5 5. Populates the entity manager class with the read and update operations 
that pass the data structure class as parameters. 

6. Creates an association named Manages 302 from the entity manager 
class to the entity class. 

7. Marks the entity manager class and structure class with properties to 
20 ensure that they are included in the generated IDL, and Java or C++ 

implementations. 

[0208] After the application of this pattern, designers are free to further 
modify the data structure class by adding, removing, or modifying members and 
25 to modify the entity managerclass by adding, removing, or modifying operations. 
The servant initialization code for the entity manager is included in any servers 
that include the entity manager. Skeletons are produced forthe entity manager 
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class and implementations are generated for the read and update methods. If 
the entity classes were created using the Data Entity Pattern , this pattern will be 
able to completely generate the implementations of read and update methods. 

5 The Data Entity Pattern 

[0209] The Data Entity Pattern may be applied to one of the RDBMS 
classes (such as a relational table, relational view, or composite view class) to 
create a Data Entity class. The Data Entity class will perform all data access 
operations and represent a "business entity" within the application. 

1 0 [021 0] The Data Entity pattern is a specialization of the Adapter pattern 
that provides a common set of interfaces for RDBMS data access. 
[0211] The persistent state of entity objects is often maintained in a 
relational database. This pattern helps the designer create entity objects that 
perform a relational to object mapping. This pattern works with the Data Entity 

1 5 Generation facility of the Expert System to provide language objects that map to 
relational tables and views. This pattern while not specific to M3, is helpful to the 
typical designer that has state information in existing relational tables that will 
make up some or all of the state of the applications entity objects. In general, the 
classes created by this pattern may not be made distributable or directly 

20 accessible to client applications. 

[0212] The Expert System menu includes the ability to apply the Data 
Entity pattern to a specific RDBMS class in the Logical View. This pattern has 
the following effect: 

1 . Creates a new package in the corresponding M3 data entity group. 
25 2. Populates the new package with a class diagram to depict the pattern 
implementation for the data entity class. 
3. Creates a class to represent the relational entity. 
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4. Creates an access class to represent the interface for the entity. . 

[021 3] In one embodiment, afterthe application of this pattern, no attempt 
is made to reconcile these designs with each other. Changes may be made to 
5 the source model and the pattern can be reapplied to the modified entity. 

Design Model Verification 

[0214] Design model verification is the process by which a Rose 
application model is scanned for correctness and completeness prior to the 
10 generation of implementation code. A software designer can invoke model 
verification through the Expert System add-in menu. Model verification is also 
invoked internally by the Expert System priorto the generation of source code. 
While scanning the Rose model, model verification can uncover several kinds of 
errors and inconsistencies: 
15 • Incomplete model 

Missing or incorrect stereotypes and properties 

Missing defaults and application settings 

Design Pattern inconsistencies 

20 [0215] After scanning the Rose model, model verification makes a 
determination as to whether or not to the model is complete, consistent, and may 
be implemented. In addition, model verification can also uncover certain design 
constructs that may result in poor performance in an M3 environment. These 
performance concerns are also noted and reported to a software designer, 

25 although they will not be used to determine if the model is complete and 
consistent. 
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Model Verification Reporting 

[021 6] Fatal errors encountered during the model verification process are 

reported immediately and the verification process is terminated. The offending 

portion of the Rose model is highlighted and a message is displayed to the 
5 software designer providing details of the error encountered. Nonfatal model 

verification results are reported in the Rose Log Window. Results are 

categorized into one of several severity levels: 

Informational messages, which contain information concerning the 

execution of the verification 
10 Warning messages, which include verification results which may highlight 

an inconsistency or omission, but do not necessarily preclude the generation of 

an implementation for a model 

Error messages, which highlight problems with the model that preclude 

the generation of source code 
1 5 Performance messages, which highlight design constructs that may result 

in less than optimal performance in an M3 environment. 

[0217] In one embodiment, The Expert System may present its model 
verification results using a specialized user interface dialog window instead of 
20 the Rose Log Window. This user interface dialog permits software designers to 
select an error or warning and go to the model construct that caused the 
verification result. 

Source Code Generation 
25 [021 8] In one embodiment, the Expert System places the source files and 
project files for an M3 server in a Windows directory. The selection of the 
directory can be affected by defaults, The Expert System add-in menu dialogs, 
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and by Rose component property settings. The Expert System "Application 
Settings" dialog can be used to specify a root directory for the Application 
development tree. By default, the application-wide source files will be placed in 
this directory, and the files that are specific to a server will be placed in 
5 server-specific subdirectories that are created as children of the root directory. 
[0219] The Expert System users can override these defaults to place 
specific source file in any desired directory by providing values to the "Directory" 
property of the corresponding Component elements. Directory specifications 
may either be absolute or relative to the application root directory. 

10 

C++ 

[0220] The C++ server code that The Expert System generates is 
intended to be utilized by an integrated development environment (IDE) such as 
Developer Studio™ . There are no constraints placed on the generated code that 
15 it depend on any Microsoft™ specific include or library files. The following 
actions will occur as part of code generation. 
Generate IDL 

Generate client and server implementation files 
Build commands will be generated for Developer Studio™ Visual C++ 
20 and other IDE's. 

Server configuration will be in the form of an ICF file. 

Client Implementation 

[0221] In one embodiment, a simple client console application is 
25 generated with the project. This client will contain code that will create a 
bootstrap and find one of the server's factories and instantiate it. 
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Server Implementation 

[0222] This code module implements three services: initialize, release 
and create_servant. Initialize will create a factory reference and register it with 
the factory finder. Release will unregister the factory. Create_servantwill create 
5 and return an implementation. 

Server Factory Implementation 

[0223] This code module defines a factory class for each class identified 
as a factory in the Rose model. Each factory will support at least one function 
10 called create_object from the COS life cycle extension simple factory, in 
additional to any other factory functions defined in the model. 

Servant Implementation 

[0224] This code module contains the implementation for each interface 
15 exported to the implementation repository. A C++ class is created for each 
interface and a method defined for each operation in the interface. If pseudo 
code has been defined in Rose for a particular function, it will be included in the 
method stub as a comment. Each class is defined in a separate file, which has 
the same name as the class. 

20 

Configuration (ICF file) 

[0225] This file contains a list of C++ classes included in the project and 
the activation and transaction policies for the factories and servers. 

25 Project File 

[0226] If the target environment is Windows based, then this is a project 
file (DSP) that can be used to load the generated code into the IDE. If it is not, 
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then the project file generated is in the form of a makefile, which can be built on 
the target platform. 

Java 

5 [0227] The Java server code that The Expert System generates is 
intended to operate within the Java server environment that is being created as 
part of the IcedJava project. The artifacts necessary to support Java server 
development closely align with the artifacts that are necessary to support C++ 
server development. 

10 

Configuration (XML file) 

[0228] This file contains a list of java files that will be inserted into a Java 
archive for this project. It also contains activation and transaction policies for the 
factories and servers. 

15 

Model Mappings 

[0229] The following sections describe the mapping between ROSE 
model constructions and the contents of the generated source files. 

20 IDL Generation 

[0230] The Interface Definition Language (IDL) file describes the external 
CORBA interface into an M3 application. Application designers have complete 
flexibility to partition their CORBA interface definitions into separate IDL files in 
separate directories. 

25 

Modules 

[0231] Applications often group externally visible interfaces into Modules. 
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These modules generally correspond to a natural partitioning of the application. 
The partitioning of interfaces into modules helps to segment a large, complicated 
application into smaller, more easily understood collections of behavior. 
Application designers create Modules using Logical View Packages. A 
5 Package becomes a CORBA Module by setting the "CORBAModule" 
stereotype. CORBA elements under the package are then included within the 
scope of that module. Modules may be nested within other modules. 

Interfaces 

10 [0232] To specify that a Class should be included as an interface 
definition within the generated IDL, set the class stereotype to "Interface". 
Although CORBA permits one to define an Interface outside of the scope of a 
module, in The Expert System Interfaces must have a CORBA Module 
stereotype package somewhere in their parentage. All of the attributes, 

1 5 relationships, and operations that are associated with this Class specification will 
be included in the generated IDL as interface attributes and operations. 

Data Type Definitions 

[0233] To specify that a Class should be included as a type definition 
20 within the generated IDL, the class stereotype is set to CORBATypedef. 

Constants 

[0234] To specify that a Class should be included as a constant definition 
within the generated IDL, set the class stereotype to CORBAConstant, the class 
25 property I mplementationType to the type of the constant, and the class property 
ConstValue to the value of the constant. 
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Structures 

[0235] To specify that a Class should be included as a structure definition 
within the generated IDL, set the class stereotype to CORBAStruct. Both 
Attributes and Roles will be included in the structure. Each has an "Order" 
5 property that may be used to establish a relative positioning of the elements 
within a structure. 

Unions 

[0236] To specify that a Class should be included as a union definition 
10 within the generated IDL, set the class stereotype to CORBAUnion . The 
attributes and relationships of the class define the union elements, as is the case 
for CORBAStruct classes. 

Enumerations 

1 5 [0237] To specify that a Class should be included as an enumerated value 
within the generated IDL, set the class stereotype to CORBAEnum. The 
Attributes of the class define the possible enum values. The Order property may 
be used to explicitly set a relative positioning of possible enum values. 

20 C++ Code Generation 

[0238] The C++ code generation model mapping is adopted from the 
Rational Rose 98 IDL generation facility. 

Java Code Generation 
25 [0239] The Java code generation model mapping is adopted from the 
Rational Rose 98 IDL generation facility. 
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M3 Server Projects 

[0240] Servers are executable processes that provide implementations 
for a set of interfaces for an M3 application. These Servers generally correspond 
to a natural partitioning of an application, often from the perspective of optimizing 

5 transaction throughput, distribution load balancing and other network 
configuration considerations. An application Rose model may specify one or 
more M3 servers are to be built as part of an M3 application. Like the grouping 
of interfaces into CORBA Modules, the grouping of interface implementations 
into Servers is specified in Rose by using Components. Designers specify the 

1 0 creation of an M3 server by setting the component's stereotype to "M3 Server". 
Interfaces are then selected for inclusion within a server by dragging classes from 
one of the Logical Views in the Browser window to the desired Server 
Component. 

[0241 ] The partitioning of interface implementations within a Server and 
1 5 the grouping of interfaces into CORBA Modules may or may not align on the 
same boundaries. The same Rose Component objects may be used to specify 
both constructions. 

[0242] The foregoing description has been provided for the purposes of 
20 illustration and description. It is not intended to be exhaustive or to limit the 
invention to the precise forms disclosed. Obviously, many modifications and 
variations will be apparent to the practitioner skilled in the art. The embodiments 
were chosen and described in order to best explain the principles of the invention 
and its practical application, thereby enabling others skilled in the art to 
25 understand the invention for various embodiments and with various modifications 
that are suited to the particular use contemplated. It is intended that the scope 
of the invention be defined by the following claims and their equivalence. 
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